<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><meta http-equiv="Content-Language" content="zh-CN"><title>busctl
  中文手册 [金步国]</title><style>
@font-face { font-family: "JinBuGuoWebMono"; src: url("http://www.jinbuguo.com/d/mono.ttf") format("truetype"); }
* { font-family: "JinBuGuoWebMono", "Ubuntu Mono", "Consolas", "Menlo", monospace; }
body { margin:10px; }
h1 { text-align:center; background:#ddd; }
h2#auth_name { text-align:center; margin: 10px 5%; }

    a.headerlink {
      color: #c60f0f;
      font-size: 0.8em;
      padding: 0 4px 0 4px;
      text-decoration: none;
      visibility: hidden;
    }

    a.headerlink:hover {
      background-color: #c60f0f;
      color: white;
    }

    h1:hover > a.headerlink, h2:hover > a.headerlink, h3:hover > a.headerlink, dt:hover > a.headerlink {
      visibility: visible;
    }
</style><script> var _hmt = _hmt || []; (function() { var hm = document.createElement("script"); hm.src = "https://hm.baidu.com/hm.js?d286c55b63a3c54a1e43d10d4c203e75"; var s = document.getElementsByTagName("script")[0]; s.parentNode.insertBefore(hm, s); })(); </script></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><h1>busctl 中文手册</h1><h2 id="auth_name">译者：<strong><a href="http://www.jinbuguo.com/">金步国</a></strong></h2><hr><h3>版权声明</h3><p>本文译者是一位开源理念的坚定支持者，所以本文虽然不是软件，但是遵照开源的精神发布。</p><ul><li>无担保：本文译者不保证译文内容准确无误，亦不承担任何由于使用此文档所导致的损失。</li><li>自由使用：任何人都可以自由的<u>阅读/链接/打印</u>此文档，无需任何附加条件。</li><li>名誉权：任何人都可以自由的<u>转载/引用/再创作</u>此文档，但必须保留译者署名并注明出处。</li></ul><h3>其他作品</h3><p>本文译者十分愿意与他人分享劳动成果，如果你对我的其他翻译作品或者技术文章有兴趣，可以在如下位置查看现有的作品集：</p><ul><li><a href="http://www.jinbuguo.com/">金步国作品集</a> [ <a href="http://www.jinbuguo.com/">http://www.jinbuguo.com/</a> ]</li></ul><h3>联系方式</h3><p>由于译者水平有限，因此不能保证译文内容准确无误。如果你发现了译文中的错误(哪怕是错别字也好)，请来信指出，任何提高译文质量的建议我都将虚心接纳。</p><ul><li>Email(QQ)：70171448在QQ邮箱</li></ul><hr><a href="systemd.index.html">手册索引</a> ·
  <a href="systemd.directives.html">指令索引</a><span style="float:right">systemd-241</span><hr><div class="refentry"><a name="busctl"></a><div class="titlepage"></div><div class="refnamediv"><h2>名称</h2><p>busctl — 内省与监视 D-Bus 总线</p></div><div class="refsynopsisdiv"><h2>大纲</h2><div class="cmdsynopsis"><p><code class="command">busctl</code>  [OPTIONS...] [COMMAND] [<em class="replaceable"><code>NAME</code></em>...]</p></div></div><div class="refsect1"><a name="id-1.5"></a><h2 id="描述">描述<a class="headerlink" title="Permalink to this headline" href="busctl.html#%E6%8F%8F%E8%BF%B0">¶</a></h2><p><span class="command"><strong>busctl</strong></span>
    可用于内省与监视 D-Bus 总线</p></div><div class="refsect1"><a name="id-1.6"></a><h2 id="选项">选项<a class="headerlink" title="Permalink to this headline" href="busctl.html#%E9%80%89%E9%A1%B9">¶</a></h2><p>能够识别的命令行选项如下：</p><div class="variablelist"><dl class="variablelist"><dt id="--address=ADDRESS"><span class="term"><code class="option">--address=<em class="replaceable"><code>ADDRESS</code></em></code></span><a class="headerlink" title="Permalink to this term" href="busctl.html#--address=ADDRESS">¶</a></dt><dd><p>连接到
          <em class="replaceable"><code>ADDRESS</code></em>  指定的总线，
          而不是默认的总线(无论是
          <code class="option">--system</code> 系统总线还是 <code class="option">--user</code>
          用户总线)。</p></dd><dt id="--show-machine"><span class="term"><code class="option">--show-machine</code></span><a class="headerlink" title="Permalink to this term" href="busctl.html#--show-machine">¶</a></dt><dd><p>在使用 <span class="command"><strong>list</strong></span> 命令
          显示总线上的所有 peer 列表时，
          额外显示一个"MACHINE"列，指明其所属容器的名称。参见
          <a href="systemd-machined.service.html#"><span class="citerefentry"><span class="refentrytitle">systemd-machined.service</span>(8)</span></a> 手册。
          </p></dd><dt id="--unique"><span class="term"><code class="option">--unique</code></span><a class="headerlink" title="Permalink to this term" href="busctl.html#--unique">¶</a></dt><dd><p>在使用 <span class="command"><strong>list</strong></span> 命令
          显示总线上的所有 peer 列表时，仅显示
          "<code class="literal">:<em class="replaceable"><code>number</code></em>.<em class="replaceable"><code>number</code></em></code>" 格式的"唯一名"(UniqueName)。
          </p></dd><dt id="--acquired"><span class="term"><code class="option">--acquired</code></span><a class="headerlink" title="Permalink to this term" href="busctl.html#--acquired">¶</a></dt><dd><p>在使用 <span class="command"><strong>list</strong></span> 命令显示总线上的所有 peer 列表时，与 <code class="option">--unique</code> 选项正好相反，
          仅显示"易读名"(well-known name)。</p></dd><dt id="--activatable"><span class="term"><code class="option">--activatable</code></span><a class="headerlink" title="Permalink to this term" href="busctl.html#--activatable">¶</a></dt><dd><p>在使用 <span class="command"><strong>list</strong></span> 命令
          显示总线上的所有 peer 列表时，
          仅显示当前未被激活并且可以在被访问时自动激活的 peer 。</p></dd><dt id="--match=MATCH"><span class="term"><code class="option">--match=<em class="replaceable"><code>MATCH</code></em></code></span><a class="headerlink" title="Permalink to this term" href="busctl.html#--match=MATCH">¶</a></dt><dd><p>在使用 <span class="command"><strong>monitor</strong></span> 命令监视已交换的消息时，
          仅显示与 <em class="replaceable"><code>MATCH</code></em> 匹配的消息。
          参见
          <a href="http://www.jinbuguo.com/systemd/sd_bus_add_match.html#"><span class="citerefentry"><span class="refentrytitle">sd_bus_add_match</span>(3)</span></a>
          </p></dd><dt id="--size="><span class="term"><code class="option">--size=</code></span><a class="headerlink" title="Permalink to this term" href="busctl.html#--size=">¶</a></dt><dd><p>在使用 <span class="command"><strong>capture</strong></span> 命令捕获已交换的消息时，
          指定允许捕获的最大消息尺寸("snaplen")，
          默认值是 4096 字节。</p></dd><dt id="--list"><span class="term"><code class="option">--list</code></span><a class="headerlink" title="Permalink to this term" href="busctl.html#--list">¶</a></dt><dd><p>在使用 <span class="command"><strong>tree</strong></span> 命令显示对象路径时，
          不以树形缩进显示，而是以平铺列表的格式显示。</p></dd><dt id="-q"><span class="term"><code class="option">-q</code>, </span><span class="term"><code class="option">--quiet</code></span><a class="headerlink" title="Permalink to this term" href="busctl.html#-q">¶</a></dt><dd><p>与 <span class="command"><strong>call</strong></span> 命令连用，
          禁止显示应答消息。
          注意：
          错误消息依然会被显示出来，
          并且依然可以用返回值判断成败。</p></dd><dt id="--verbose"><span class="term"><code class="option">--verbose</code></span><a class="headerlink" title="Permalink to this term" href="busctl.html#--verbose">¶</a></dt><dd><p>与 <span class="command"><strong>call</strong></span> 或
          <span class="command"><strong>get-property</strong></span> 命令连用，
          表示以详细模式显示输出。</p></dd><dt id="--json=MODE"><span class="term"><code class="option">--json=</code><em class="replaceable"><code>MODE</code></em></span><a class="headerlink" title="Permalink to this term" href="busctl.html#--json=MODE">¶</a></dt><dd><p>与 <span class="command"><strong>call</strong></span> 或 <span class="command"><strong>get-property</strong></span> 命令连用，表示以 JSON 格式显示输出内容。
          <em class="replaceable"><code>MODE</code></em> 可以是 "<code class="literal">short</code>"(以最短方式输出，不带任何多余的空白或换行符)
          或 "<code class="literal">pretty</code>"(以易读方式输出，带有空白与换行符)。
          注意，从 D-Bus 信号编集(marshalling)到 JSON 的转换是无损的，
          也就是说类型信息也被嵌入了 JSON 对象树中。</p></dd><dt id="-j"><span class="term"><code class="option">-j</code></span><a class="headerlink" title="Permalink to this term" href="busctl.html#-j">¶</a></dt><dd><p>当从终端交互式调用时等价于 <code class="option">--json=pretty</code> ，
          否则等价于 <code class="option">--json=short</code>
          (特别是将输出内容通过管道传递给另一个程序时)。</p></dd><dt id="--expect-reply=BOOL"><span class="term"><code class="option">--expect-reply=</code><em class="replaceable"><code>BOOL</code></em></span><a class="headerlink" title="Permalink to this term" href="busctl.html#--expect-reply=BOOL">¶</a></dt><dd><p>与 <span class="command"><strong>call</strong></span> 命令连用，
          设置是否等待被调用的方法执行完成。
          "<code class="literal">yes</code>" 表示
          等待方法执行完成并且返回应答数据，
          然后 <span class="command"><strong>busctl</strong></span> 将返回一个可用于判断方法执行成败的返回码。
          "<code class="literal">no</code>" 表示调用方法之后不等待其执行完成也不显示应答数据，
          而是直接退出，并且不返回有意义的返回码。
          如果只是想屏蔽应答数据，
          应该使用 <code class="option">--quiet</code> 选项。
          默认值为
          "<code class="literal">yes</code>"</p></dd><dt id="--auto-start=BOOL"><span class="term"><code class="option">--auto-start=</code><em class="replaceable"><code>BOOL</code></em></span><a class="headerlink" title="Permalink to this term" href="busctl.html#--auto-start=BOOL">¶</a></dt><dd><p>与 <span class="command"><strong>call</strong></span> 命令连用，
          设置是否应该隐含的启动当前尚未运行、
          但是被配置为自动启动的服务。
          默认是
          "<code class="literal">yes</code>"</p></dd><dt id="--allow-interactive-authorization=BOOL"><span class="term"><code class="option">--allow-interactive-authorization=</code><em class="replaceable"><code>BOOL</code></em></span><a class="headerlink" title="Permalink to this term" href="busctl.html#--allow-interactive-authorization=BOOL">¶</a></dt><dd><p>与 <span class="command"><strong>call</strong></span> 命令连用，
          设置服务在执行操作时，
          是否应该强制进行交互式授权(在安全策略已配置的时候)。
          默认是
          "<code class="literal">yes</code>"</p></dd><dt id="--timeout=SECS"><span class="term"><code class="option">--timeout=</code><em class="replaceable"><code>SECS</code></em></span><a class="headerlink" title="Permalink to this term" href="busctl.html#--timeout=SECS">¶</a></dt><dd><p>与 <span class="command"><strong>call</strong></span> 命令连用，
          设置等候方法完成的最大秒数。
          注意，此处的超时设置对
           <code class="option">--expect-reply=no</code> 无效。
          可使用明确的时间单位后缀：
          us, ms, s, min, h, d, w, month, y 。
          默认值是"<code class="literal">25s</code>"
          (注意，设为"0"也等价于
          "<code class="literal">25s</code>")。</p></dd><dt id="--augment-creds=BOOL"><span class="term"><code class="option">--augment-creds=</code><em class="replaceable"><code>BOOL</code></em></span><a class="headerlink" title="Permalink to this term" href="busctl.html#--augment-creds=BOOL">¶</a></dt><dd><p>设置
          <span class="command"><strong>list</strong></span>/<span class="command"><strong>status</strong></span> 命令报告的凭据数据
          是否应该被扩展为包含来自 <code class="filename">/proc</code> 的数据。
          若设为"<code class="literal">yes</code>"(默认值)，
          那么显示的数据可能会不一致，
           因为 <code class="filename">/proc</code>
          中的数据可能会更新。</p></dd><dt id="--watch-bind=BOOL"><span class="term"><code class="option">--watch-bind=</code><em class="replaceable"><code>BOOL</code></em></span><a class="headerlink" title="Permalink to this term" href="busctl.html#--watch-bind=BOOL">¶</a></dt><dd><p>在连接到特定的 <code class="constant">AF_UNIX</code> 套接字之前，是否等待它出现在文件系统中。
          设为 yes 表示一直监视文件系统，直到所需的套接字被创建之后，才会去连接。
          默认值是 off 。</p></dd><dt id="--user"><span class="term"><code class="option">--user</code></span><a class="headerlink" title="Permalink to this term" href="busctl.html#--user">¶</a></dt><dd><p><a name="user-text"></a>与当前调用用户的用户服务管理器(systemd 用户实例)通信，
      而不是默认的系统服务管理器(systemd 系统实例)。</p></dd><dt id="--system"><span class="term"><code class="option">--system</code></span><a class="headerlink" title="Permalink to this term" href="busctl.html#--system">¶</a></dt><dd><p><a name="system-text"></a>与系统服务管理器(systemd 系统实例)通信，
      这是默认值。</p></dd><dt id="-H"><span class="term"><code class="option">-H</code>, </span><span class="term"><code class="option">--host=</code></span><a class="headerlink" title="Permalink to this term" href="busctl.html#-H">¶</a></dt><dd><p><a name="host-text"></a>操作指定的远程主机。可以仅指定一个主机名(hostname)，
      也可以使用 "<code class="literal">username@hostname</code>" 格式。
      hostname 后面还可以加上
      SSH监听端口(以冒号"<code class="literal">:</code>"分隔)与容器名(以正斜线"<code class="literal">/</code>"分隔)，
      也就是形如 "<code class="literal">hostname:port/container</code>" 的格式，
      以表示直接连接到指定主机的指定容器内。
      操作将通过SSH协议进行，以确保安全。
      可以通过
      <span class="command"><strong>machinectl -H
      <em class="replaceable"><code>HOST</code></em></strong></span> 命令列出远程主机上的所有容器名称。IPv6地址必须放在方括号([])内。</p></dd><dt id="-M"><span class="term"><code class="option">-M</code>, </span><span class="term"><code class="option">--machine=</code></span><a class="headerlink" title="Permalink to this term" href="busctl.html#-M">¶</a></dt><dd><p><a name="machine-text"></a>在本地容器内执行操作。
      必须明确指定容器的名称。</p></dd><dt id="--no-pager"><span class="term"><code class="option">--no-pager</code></span><a class="headerlink" title="Permalink to this term" href="busctl.html#--no-pager">¶</a></dt><dd><p>不将程序的输出内容管道(pipe)给分页程序。</p></dd><dt id="--no-legend"><span class="term"><code class="option">--no-legend</code></span><a class="headerlink" title="Permalink to this term" href="busctl.html#--no-legend">¶</a></dt><dd><p>不输出列标题，
      也就是不在输出列表的头部和尾部显示字段的名称。</p></dd><dt id="-h"><span class="term"><code class="option">-h</code>, </span><span class="term"><code class="option">--help</code></span><a class="headerlink" title="Permalink to this term" href="busctl.html#-h">¶</a></dt><dd><p><a name="help-text"></a>显示简短的帮助信息并退出。
    </p></dd><dt id="--version"><span class="term"><code class="option">--version</code></span><a class="headerlink" title="Permalink to this term" href="busctl.html#--version">¶</a></dt><dd><p><a name="version-text"></a>显示简短的版本信息并退出。</p></dd></dl></div></div><div class="refsect1"><a name="id-1.7"></a><h2 id="命令">命令<a class="headerlink" title="Permalink to this headline" href="busctl.html#%E5%91%BD%E4%BB%A4">¶</a></h2><p>能够识别的命令如下：</p><div class="variablelist"><dl class="variablelist"><dt id="list"><span class="term"><span class="command"><strong>list</strong></span></span><a class="headerlink" title="Permalink to this term" href="busctl.html#list">¶</a></dt><dd><p>显示总线上的所有peer(依据服务名称)，
        这是默认命令。
        默认同时显示"唯一名"(UniqueName)与"易读名"(well-known name)，
        但是可以使用 <code class="option">--unique</code> 与 <code class="option">--acquired</code>
        选项进行修改。</p></dd><dt id="status SERVICE"><span class="term"><span class="command"><strong>status</strong></span>  [<em class="replaceable"><code>SERVICE</code></em>]</span><a class="headerlink" title="Permalink to this term" href="busctl.html#status%20SERVICE">¶</a></dt><dd><p>如果 SERVICE 是一个总线服务的"唯一名"或"易读名"，
         那么显示该服务的进程信息及凭证信息。
        如果 SERVICE 是一个进程的PID，那么显示该进程的进程信息及凭证信息。
        如果未指定 SERVICE 参数，
        那么显示总线所有者的进程信息及凭证信息。</p></dd><dt id="monitor SERVICE"><span class="term"><span class="command"><strong>monitor</strong></span>  [<em class="replaceable"><code>SERVICE</code></em>...]</span><a class="headerlink" title="Permalink to this term" href="busctl.html#monitor%20SERVICE">¶</a></dt><dd><p>监视已交换的消息。
        如果未指定 <em class="replaceable"><code>SERVICE</code></em> 参数，那么显示总线上的所有消息。
        如果指定了 <em class="replaceable"><code>SERVICE</code></em> 参数("唯一名"或"易读名")，
        那么仅显示到达此peer或者从此peer发出的消息。
        可使用 <span class="keycap"><strong>Ctrl</strong></span>+<span class="keycap"><strong>C</strong></span>
        中断监视。</p></dd><dt id="capture SERVICE"><span class="term"><span class="command"><strong>capture</strong></span>  [<em class="replaceable"><code>SERVICE</code></em>...]</span><a class="headerlink" title="Permalink to this term" href="busctl.html#capture%20SERVICE">¶</a></dt><dd><p>与 <span class="command"><strong>monitor</strong></span> 命令类似，
        不同之处在于以 pcap 格式输出(详见 <a class="ulink" href="https://wiki.wireshark.org/Development/LibpcapFileFormat" target="_top">Libpcap
        File Format</a>)。
        强烈推荐将标准输出(STDOUT)重定向到一个文件中，然后使用
        <a href="https://linux.die.net/man/1/wireshark"><span class="citerefentry"><span class="refentrytitle">wireshark</span>(1)</span></a>
        工具
        查看与分析。</p></dd><dt id="tree SERVICE"><span class="term"><span class="command"><strong>tree</strong></span>  [<em class="replaceable"><code>SERVICE</code></em>...]</span><a class="headerlink" title="Permalink to this term" href="busctl.html#tree%20SERVICE">¶</a></dt><dd><p>显示服务的对象树。
        如果给出了 <em class="replaceable"><code>SERVICE</code></em> 参数，
        那么仅显示指定服务的对象树，
        否则
        显示总线上所有具有"易读名"服务的对象树。</p></dd><dt id="introspect SERVICE OBJECT INTERFACE"><span class="term"><span class="command"><strong>introspect</strong></span>   <em class="replaceable"><code>SERVICE</code></em>    <em class="replaceable"><code>OBJECT</code></em>   [<em class="replaceable"><code>INTERFACE</code></em>]</span><a class="headerlink" title="Permalink to this term" href="busctl.html#introspect%20SERVICE%20OBJECT%20INTERFACE">¶</a></dt><dd><p>显示SERVICE服务上OBJECT对象(以路径表示)的
         interface, method, property, signal 值。
        如果指定了 INTERFACE 参数，
        那么
        仅输出指定接口上的成员。</p></dd><dt id="call SERVICE OBJECT INTERFACE METHOD SIGNATURE ARGUMENT"><span class="term"><span class="command"><strong>call</strong></span>   <em class="replaceable"><code>SERVICE</code></em>    <em class="replaceable"><code>OBJECT</code></em>    <em class="replaceable"><code>INTERFACE</code></em>    <em class="replaceable"><code>METHOD</code></em>   [<em class="replaceable"><code>SIGNATURE</code></em>  [<em class="replaceable"><code>ARGUMENT</code></em>...]]</span><a class="headerlink" title="Permalink to this term" href="busctl.html#call%20SERVICE%20OBJECT%20INTERFACE%20METHOD%20SIGNATURE%20ARGUMENT">¶</a></dt><dd><p>调用一个方法并显示应答。
        必须指定服务名称(SERVICE)、对象路径(OBJECT)、接口名称(INTERFACE)、方法名称(METHOD)。
        如果要给方法传递参数，
        那么必须使用类型标记(SIGNATURE)后跟一个参数字符串(ARGUMENT)。
        格式细节参见下面的"参数格式"小节。
        可以使用
        <code class="option">--quiet</code> 选项抑制输出。</p></dd><dt id="get-property SERVICE OBJECT INTERFACE PROPERTY"><span class="term"><span class="command"><strong>get-property</strong></span>   <em class="replaceable"><code>SERVICE</code></em>    <em class="replaceable"><code>OBJECT</code></em>    <em class="replaceable"><code>INTERFACE</code></em>    <em class="replaceable"><code>PROPERTY</code></em>... </span><a class="headerlink" title="Permalink to this term" href="busctl.html#get-property%20SERVICE%20OBJECT%20INTERFACE%20PROPERTY">¶</a></dt><dd><p>显示对象属性的当前值。
        必须指定
        服务名称(SERVICE)、对象路径(OBJECT)、接口名称(INTERFACE)、属性名称(PROPERTY)。
        如果同时指定了多个属性名称，那么将按照每行一个，依次显示每个属性的当前值。
        默认以精简格式输出，
        但是可以使用 <code class="option">--verbose</code> 选项
        以详细格式输出。</p></dd><dt id="set-property SERVICE OBJECT INTERFACE PROPERTY SIGNATURE ARGUMENT"><span class="term"><span class="command"><strong>set-property</strong></span>   <em class="replaceable"><code>SERVICE</code></em>    <em class="replaceable"><code>OBJECT</code></em>    <em class="replaceable"><code>INTERFACE</code></em>    <em class="replaceable"><code>PROPERTY</code></em>    <em class="replaceable"><code>SIGNATURE</code></em>    <em class="replaceable"><code>ARGUMENT</code></em>... </span><a class="headerlink" title="Permalink to this term" href="busctl.html#set-property%20SERVICE%20OBJECT%20INTERFACE%20PROPERTY%20SIGNATURE%20ARGUMENT">¶</a></dt><dd><p>设置对象属性的当前值。
        必须指定下列参数：
        服务名称(SERVICE)、对象路径(OBJECT)、接口名称(INTERFACE)、
        属性名称(PROPERTY)、类型标记(SIGNATURE)、参数字符串(ARGUMENT)。</p></dd><dt id="help"><span class="term"><span class="command"><strong>help</strong></span></span><a class="headerlink" title="Permalink to this term" href="busctl.html#help">¶</a></dt><dd><p>显示语法帮助</p></dd></dl></div></div><div class="refsect1"><a name="id-1.8"></a><h2 id="参数格式">参数格式<a class="headerlink" title="Permalink to this headline" href="busctl.html#%E5%8F%82%E6%95%B0%E6%A0%BC%E5%BC%8F">¶</a></h2><p> <span class="command"><strong>call</strong></span> 与
    <span class="command"><strong>set-property</strong></span> 命令都接收一个类型标记(SIGNATURE)与多个参数字符串(ARGUMENT)。
    有关"类型标记"的详细说明，
    参见 <a class="ulink" href="http://dbus.freedesktop.org/doc/dbus-specification.html#type-system" target="_top">Type
    system chapter of the D-Bus specification</a> 文档的"Type System"小节。
    对于简单类型(Basic types)，
    类型标记(SIGNATURE)后面的每个参数(ARGUMENT)都必须是参数值的字符串表示。
    布尔类型真值可以表示为 "<code class="literal">true</code>", "<code class="literal">yes</code>",
    "<code class="literal">on</code>", "<code class="literal">1</code>" ；
    布尔类型假值可以表示为 "<code class="literal">false</code>",
    "<code class="literal">no</code>", "<code class="literal">off</code>",
    "<code class="literal">0</code>" 。
    对于数组，先是一个表示数组项数的数字，然后跟着数组中的每一项。
    对于变量，先是一个表示变量类型的字符，然后跟着变量的值。
    对于字典与结构，
    直接指定其内容即可。</p><p>例如，
    </p><pre class="programlisting">s jawoll</pre><p> 是一个简单的字符串 "<code class="literal">jawoll</code>" ，
    "s"是类型标记，"jawoll"是参数字符串。</p><p>
    </p><pre class="programlisting">as 3 hello world foobar</pre><p>
    是一个字符串数组，包含3个成员，分别是
    "<code class="literal">hello</code>", "<code class="literal">world</code>",
    "<code class="literal">foobar</code>"</p><p>
    </p><pre class="programlisting">a{sv} 3 One s Eins Two u 2 Yes b true</pre><p>
    是一个字典数组，
    该字典将字符串映射为变量，包含3个成员，分别是：
    字符串 "<code class="literal">One</code>"
    映射到字符串 "<code class="literal">Eins</code>" ，
    字符串 "<code class="literal">Two</code>" 映射到32位无符号整数"2"，
    字符串 "<code class="literal">Yes</code>" 映射到
    布尔真值。</p><p>注意， <span class="command"><strong>call</strong></span>,
    <span class="command"><strong>get-property</strong></span>, <span class="command"><strong>introspect</strong></span>
    命令在输出应答时也同样是这个格式。
    由于这个格式过于精简不易理解，
    所以 <span class="command"><strong>call</strong></span> 与
    <span class="command"><strong>get-property</strong></span> 命令
    提供了
    <code class="option">--verbose</code> 选项用于输出详细的、易于理解的多行输出格式。</p></div><div class="refsect1"><a name="id-1.9"></a><h2 id="例子">例子<a class="headerlink" title="Permalink to this headline" href="busctl.html#%E4%BE%8B%E5%AD%90">¶</a></h2><div class="example"><a name="id-1.9.2"></a><p class="title"><b>例 1. 读写属性</b></p><div class="example-contents"><p>下面的两个命令，首先写入一个属性，然后再读取它。
      该属性位于
      "<code class="literal">org.freedesktop.systemd1</code>" 服务的
      "<code class="literal">/org/freedesktop/systemd1</code>" 对象中，
      属性名是 "<code class="literal">org.freedesktop.systemd1.Manager</code>"
      接口上的 "<code class="literal">LogLevel</code>" ，
      此属性是一个简单的字符串：</p><pre class="programlisting"># busctl set-property org.freedesktop.systemd1 /org/freedesktop/systemd1 org.freedesktop.systemd1.Manager LogLevel s debug
# busctl get-property org.freedesktop.systemd1 /org/freedesktop/systemd1 org.freedesktop.systemd1.Manager LogLevel s "debug"
</pre></div></div><br class="example-break"><div class="example"><a name="id-1.9.3"></a><p class="title"><b>例 2. 精简输出与详细输出</b></p><div class="example-contents"><p>下面的两个命令，两次读取同一个属性(字符串数组类型)，
      第一次以精简格式显示，
      第二次以详细格式显示：</p><pre class="programlisting">$ busctl get-property org.freedesktop.systemd1 /org/freedesktop/systemd1 org.freedesktop.systemd1.Manager Environment
as 2 "LANG=en_US.utf8" "PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin"
$ busctl get-property --verbose org.freedesktop.systemd1 /org/freedesktop/systemd1 org.freedesktop.systemd1.Manager Environment
ARRAY "s" {
        STRING "LANG=en_US.utf8";
        STRING "PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin";
};</pre></div></div><br class="example-break"><div class="example"><a name="id-1.9.4"></a><p class="title"><b>例 3. 调用方法</b></p><div class="example-contents"><p>下面的命令，
      在 "<code class="literal">org.freedesktop.systemd1</code>" 服务的 "<code class="literal">/org/freedesktop/systemd1</code>" 对象的
      "<code class="literal">org.freedesktop.systemd1.Manager</code>"
      接口上调用了
       "<code class="literal">StartUnit</code>"
       方法，
      并且给此方法传递了
      "<code class="literal">cups.service</code>" 与
      "<code class="literal">replace</code>"
      两个字符串。
      而此方法返回了一个对象路径：</p><pre class="programlisting"># busctl call org.freedesktop.systemd1 /org/freedesktop/systemd1 org.freedesktop.systemd1.Manager StartUnit ss "cups.service" "replace"
o "/org/freedesktop/systemd1/job/42684"</pre></div></div><br class="example-break"></div><div class="refsect1"><a name="id-1.10"></a><h2 id="参见">参见<a class="headerlink" title="Permalink to this headline" href="busctl.html#%E5%8F%82%E8%A7%81">¶</a></h2><p>
      <a href="http://dbus.freedesktop.org/doc/dbus-daemon.1.html"><span class="citerefentry"><span class="refentrytitle">dbus-daemon</span>(1)</span></a>,
      <a class="ulink" href="https://www.freedesktop.org/wiki/Software/dbus" target="_top">D-Bus</a>,
      <a href="http://www.jinbuguo.com/systemd/sd-bus.html#"><span class="citerefentry"><span class="refentrytitle">sd-bus</span>(3)</span></a>,
      <a href="systemd.html#"><span class="citerefentry"><span class="refentrytitle">systemd</span>(1)</span></a>,
      <a href="machinectl.html#"><span class="citerefentry"><span class="refentrytitle">machinectl</span>(1)</span></a>,
      <a href="https://linux.die.net/man/1/wireshark"><span class="citerefentry"><span class="refentrytitle">wireshark</span>(1)</span></a>
    </p></div></div></body></html>
